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EAPS Configuration Commands 


Chapter 1 EAPS Configuration Commands 


1.1. Global Commands 
1.1.1. ether-ring 


Syntax 
To set an instance of ring and enter the node mode, run the following command: 
ether-ring id 
To cancel an instance of ring, run the following command: 


no ether-ring id 


Parameters 


Parameters Description 


id ID of the node 


Default Value 
By default, the ring node is not configured. 
Command Mode 
Global configuration mode 
Usage Guidelines 
STP should not be disabled before the configuration of node instance. 


Example 
Switch_config#ether-ring 1 


Related Command 


None 
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1.1.2 control-vian 


Syntax 


To set the control VLAN of the ring node, run the following command: 


control-vian vian-id 


Parameters 


Parameters 


Description 


vian-id 


ID of the control VLAN 


Value range: 1-4094 


Default Value 


By default, the control VLAN of a node is not configured. 


Command Mode 


Node configuration mode for the Ethernet ring 


Usage Guidelines 


1. Any VLAN can be configured as the control VLAN of the node. If you specify the 
control VLAN, the system VLAN will be created consequently. The user doesn't need to 
create the system VLAN manually. 


2. After the control VLAN and node types of the Ethernet ring are configured, you 
cannot modify the control VLAN even if the system exits from the Ethernet ring 


configuration mode because the Ethernet ring has already been started. 


Example 


Switch_config#ether-ring 1 


Switch_config_ring1#control-vian 2 


Related Command 


ether-ring 
master-node 


transit-node 
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1.1.3. master-node 


Syntax 


To configure an Ethernet ring as a master node, run the following command: 


master-node 
Parameters 
None 
Default Value 
By default, the node type is not configured. 
Command Mode 
Node configuration mode 
Usage Guidelines 


1. Anode can be set to be a master node or a transit node. 
2. After the control VLAN and node types of the Ethernet ring are configured, you 


cannot modify the control VLAN even if the system exits from the Ethernet ring 
configuration mode because the node of the Ethernet ring has already been started. 


Example 


The following example shows how to configure the node to master-node. 
Switch_config#ether-ring 1 

Switch_config_ring1#control-vian 2 

Switch_config_ring1#master-node 


Related Command 


control-vian 


transit-node 


1.1.4 transit-node 


Syntax 


To configure the node type to be a transit node, run the following command. 
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transit-node 
Parameters 
None 
Default Value 
By default, the node type is not configured. 
Command Mode 
Node configuration mode 
Usage Guidelines 


1. Anode can be set to be a master node or a transit node. 
2. After the control VLAN and node types of the Ethernet ring are configured, you 


cannot modify the control VLAN even if the system exits from the Ethernet ring 
configuration mode because the node of the Ethernet ring has already been started. 


Example 


Switch_config#ether-ring 1 
Switch_config_ring1#control-vlan 2 
Switch_config_ring1#transit-node 


Related Command 


control-vian 


master-node 


1.1.5 hello-time 


Syntax 


To configure the cycle for the master node to transmit the HEALTH packets of the 
Ethernet ring, run the following command: 


hello-time value 
To resume the default value of the cycle, run the following command: 


no hello-time 
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Parameters 


Parameters Description 


value Stands for a time value, whose unit is second. 


The default value is one second. The value ranges between 1 
and 10 seconds. 


Default Value 

By default, the hello-time is one second. 
Command Mode 

Node configuration mode for the Ethernet ring 
Usage Guidelines 


1. The hello-time configuration validates only on the master node. 
2. By default, the value of the hello-time is smaller than that of the fail-time, which 


avoids the Ethernet ring protocol from being shocked. The hello-time needs to modify 
after modifying fail-time. 


Example 


Switch_config#ether-ring 1 
Switch_config_ring1#control-vian 2 
Switch_config_ring1#master-node 
Switch_config_ring1#hello-time 2 


Related Command 
fail-time 


1.1.6 _ fail-time 


Syntax 


To configure the time cap of waiting for the HEALTH packets for the secondary port of 
the master node, run the following command: 


fail-time value 
To resume the default value of the fail-time, run the following command: 


no fail-time 


EAPS Configuration Commands 


Parameters 


Parameters Description 


value Stands for a time value, whose unit is second. 


The default value is three seconds. The value ranges between 3 
and 30 seconds. 


Default Value 

By default, the fail-time is 3 seconds. 
Command Mode 

Node configuration mode for the Ethernet ring 
Usage Guidelines 


1. The fail-time configuration validates only on the master node. 
2. By default, the value of the fail-time is triple of the hello-time, which avoids the 


Ethernet ring protocol from being shocked. The hello-time needs to modify after 
modifying fail-time. 


Example 


Switch_config#ether-ring 1 
Switch_config_ring1#control-vlan 2 
Switch_config_ring1#master-node 
Switch_config_ring1#hello-time 2 
Switch_config_ring1#fail-time 6 


Related Command 
hello-time 


1.1.7 pre-forward-time 


Syntax 


To configure the time of maintaining the pre-forward state on the transit port, run the 
following command. 


pre-forward-time value 
To resume the default value of the pre-forward-time, run the following command. 


no pre-forward-time 
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Parameters 


Parameters Description 


value Stands for a time value, whose unit is second. 


The default value is three seconds. The value ranges between 3 
and 30 seconds. 


Default Value 
By default, the pre-forward-time is 3 seconds. 


Command Mode 


Node configuration mode for the Ethernet ring 
Usage Guidelines 


1. The pre-forward-time configuration validates only on the transit node. 

2. By default, the pre-forward-time on the transit node is triple the value of the 
hello-time on the master node, which avoids the network loop from being occurred after 
the transmission link recovers from disconnection. After the hello-time of the master 


node is modified, the corresponding pre-forward-time on the transit node need be 
adjusted. 


Example 


Switch_config#ether-ring 1 
Switch_config_ring1#control-vlan 2 
Switch_config_ring1#transit-node 
Switch_config_ring1#pre-forward-time 8 


Related Command 


None 
1.2 Port Configuration Commands 
1.2.1. ether-ring primary-port 


Syntax 


To set a port to be the primary port of a master node, run the following command: 


ether-ring id primary-port 
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To cancel the primary port configuration of a port, run the following command: 


no ether-ring jd primary-port 


Parameters 


Parameters Description 


id ID of the node 


Default Value 

The primary port is not configured by default. 
Command Mode 

Interface configuration mode 
Usage Guidelines 


The primary port can be configured only after the control VLAN and node type of the 
Ethernet ring are configured, and when the node type is the master node. 


The command cannot be supported on the PON port. 


Example 


Switch_config#interface GO/1 
Switch_config_g0/1#ether-ring 1 primary-port 
Switch_config_g0/1#exit 


Related Command 


master-node 


ether-ring secondary-port 


1.2.2. ether-ring secondary-port 


Syntax 


To set a port to be the secondary port of a master node, run the following command: 
ether-ring id secondary-port 
To cancel the secondary port configuration, run the following command: 


no ether-ring id secondary-port 
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Parameters 


Parameters Description 


id ID of the node 


Default Value 
The secondary port on the master node is not configured by default. 
Command Mode 


The physical port configuration mode and the converged port configuration mode 
Note: The versions of BDCOM switch software prior to version 2.0.1L and the versions 


of hi-end switch software prior to version 4.0.0M do not support the configuration of the 
converged port. 


Usage Guidelines 


The primary port can be configured only after the control VLAN and node type of the 
Ethernet ring are configured, and when the node type is the master node. 


The command cannot be supported on the PON port. 


Example 


Switch_config#interface GO/3 
Switch_config_g0/3#ether-ring 1 secondary-port 
Switch_config_g0/3#exit 


Related Command 


master-node 


ether-ring primary-port 


1.2.3 ether-ring transit-port 


Syntax 


To set a port to be the transit port of a transit node, run the following command: 
ether-ring id transit-port 
To cancel the transit port, run the following command: 


no ether-ring jd transit-port 
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Parameters 


Parameters Description 


id ID of the node 


Default Value 

The transit port on the transit node is not configured by default. 
Command Mode 

Interface configuration mode 
Usage Guidelines 


The transit port can be configured only after the control VLAN and node type of the 
Ethernet ring are configured, and when the node type must be the transit node. Two 
transit ports can be configured on one transit node. 


The command cannot be supported on the PON port. 


Example 


Switch_config# interface GO/1 
Switch_config_g0/1#ether-ring 1 transit-port 
Switch_config_g0/1#exit 
Switch_config#interface GO/3 
Switch_config_g0/3#ether-ring 1 transit-port 
Switch_config_g0/3#exit 


Related Command 


transit-node 


1.3. Show 


1.3.1. show ether-ring 


Syntax 


To display the summary information about the Ethernet-ring node, run the following 
command: 


show ether-ring id 
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To display the detailed information about the Ethernet-ring node, run the following 
command: 


show ether-ring id detail 
To display the information about the Ethernet-ring port, run the following command: 
show ether-ring /d interface intf-name 


To display all summary information about the Ethernet-ring node, run the following 
command: 


show ether-ring <cr> 


Parameters 
Parameters Description 
id ID of the node 
intf-name Name of an interface 


Default Value 
None 
Command Mode 


EXEC mode, global configuration mode, node configuration mode or port configuration 
mode 


Usage Guidelines 
None 
Example 
None 
Related Command 


None 
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